home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / go.arc / GO.DOC next >
Text File  |  1988-07-30  |  6KB  |  187 lines
  1.  
  2.  
  3.  
  4.  
  5.                                    GO
  6.  
  7.            A program to change disk drives and subdirectories
  8.                         PC/MS-DOS V2.x and later
  9.                   (c) 1986 DeVoney, Leslie, Stegemoller
  10.                             Indianapolis, IN
  11.  
  12.     This program is place in the public domain with the restriction that
  13.     the program is not to be sold. Any other commercial (or private use, for
  14.     that matter) is welcome.
  15.  
  16.  
  17.     Introduction
  18.     ------------
  19.     GO.EXE is a program to quickly change disk drives and subdirectories. 
  20.     Go was written by Chris DeVoney (Que Corporation) and appeared in /c, 
  21.     the Journal for C Users by Que Corp. It has since been modified by 
  22.     DeVoney, Tim Leslie (Ecosoft, Inc.), and Alan Stegemoller (Carmel 
  23.     Valley Associates). The purpose of the program was to provide a quick 
  24.     method to change subdirectories without typing long path names. The 
  25.     program shines with hard disk systems, and is generally worthless on 
  26.     floppy-based systems.
  27.  
  28.     Installing GO
  29.     -------------
  30.     To use GO, copy GO.EXE to a subdirectory specified by the PATH
  31.     command. (If you have a hard disk system and are not using the DOS PATH
  32.     command, look in your DOS manual or buy a book on PC/MS-DOS NOW!).
  33.     The customary directory is \BIN.
  34.  
  35.     Creating GO.DAT
  36.     ---------------
  37.     You must create (or copy) a file called GO.DAT. This file should be
  38.     placed in a subdirectory on your PATH. The file can be created
  39.     and maintained using any ASCII text editor. Each line of the file
  40.     contains the name and the drive/subdirectory information for GO. The
  41.     format of a line is:
  42.  
  43.          keyword drive:\path
  44.          ...
  45.          keyword drive:\path
  46.  
  47.     The keyword is any name you wish. Make it memorable and short.  The
  48.     drive and path name is the drive and subdirectory you wish to change
  49.     to when invoking GO. You may use a comma, space, tab or semicolon
  50.     between the keyword and the drive/pathname. Upper and lower case 
  51.     characters may be freely intermixed.
  52.  
  53.     Be forewarned that GO does not check the format of the lines in the 
  54.     data file. This keeps GO small and tight, but means you might get into 
  55.     trouble if you do not enter a line correctly.
  56.  
  57.     You can make changes in GO.DAT at any time. GO rereads GO.DAT every time     the
  58.     the program is invoked.
  59.  
  60.  
  61.                                     1
  62.  
  63.  
  64.  
  65.  
  66.     For efficiency, put your most frequently used keywords at the top of
  67.     the file. GO reads the lines from GO.DAT in sequential order. The
  68.     further the line is in the file, the more GO must read before it 
  69.  
  70.     finds the keyword.
  71.  
  72.     Using GO
  73.     --------
  74.     To use GO, type
  75.  
  76.             GO                      or
  77.             GO keyword              or
  78.             GO d:\path
  79.  
  80.     The first form (no parameters) prints a paginated list of the
  81.     keywords and associated drive and path names. When --MORE-- is
  82.     displayed, pressing Esc or Ctrl-C ends the display or any other key
  83.     press displays the next screenful of information.
  84.             
  85.     The second form causes GO to move the drive/subdirectory
  86.     associated with keyword. keyword is one of the keywords in the 
  87.     GO.DAT file.
  88.             
  89.     The third form is similiar to DOS's CD. If a disk drive is specified 
  90.     (disk drive name is optional for this form), GO makes the specified 
  91.     disk drive the current disk drive. 
  92.  
  93.  
  94.     For example, given this GO.DAT 
  95.  
  96.     c c:\lang\c
  97.     basic c:\lang\basic
  98.     cobol c:\lang\cobol
  99.     scr d:\scratch
  100.     tmp d:\scratch\tmp
  101.  
  102.     the command
  103.  
  104.             go scr
  105.  
  106.     would make drive d: the current disk drive and \scratch the current
  107.     directory. This line
  108.  
  109.             GO c:\bin
  110.  
  111.     would make c: the current disk drive and \bin the current
  112.     subdirectory.
  113.  
  114.     Diagnostics
  115.     ----------
  116.  
  117.     If GO is successful, no message is given. 
  118.  
  119.     If go cannot match the keyword, or GO cannot change to a named 
  120.     drive, subdirectory, the message
  121.  
  122.  
  123.                                     2
  124.  
  125.  
  126.  
  127.  
  128.             go: where is pathname?
  129.  
  130.     is displayed. pathname is either the path you gave to GO (if using it
  131.     like CD) or the keyword you typed. Most likely you misspelled the
  132.     keyword when invoking GO.
  133.  
  134.     If GO cannot change to the drive and subdirectory specified by a 
  135.     keyword, the message
  136.  
  137.             go: cannot change to pathname!
  138.  
  139.     is displayed. pathname is the drive and subdirectory associated with
  140.     the keyword. Most likely the line with the keyword you typed has an
  141.     incorrect path or you have renamed or deleted a directory and did not
  142.     update the GO data file.
  143.  
  144.     GO environmental variable
  145.     -------------------------
  146.     If you wish to place GO.DAT in a different subdirectory, or use a
  147.     different name for the data file, GO searches the environment for a
  148.     variable called GO. This variable should have the complete drive,
  149.     path, and file name of the data file. For example, if you wished to
  150.     place the data file in a directory called TEST on drive C, you would
  151.     use the command
  152.             
  153.             set go=c:\test\go.dat
  154.  
  155.     Notice when using the GO variable, you must specify the file name.
  156.     When the GO environmental variable is used, GO makes no assumption 
  157.     about the name of the data file. 
  158.  
  159.     To use a GO data file called MYDATA in C:\TEST, you would use
  160.  
  161.             set go=c:\test\mydata
  162.  
  163.  
  164.     GO.C
  165.     ----
  166.     The source code for GO is in a file called GO.C. The program has been
  167.     compiled with the Ecosoft C88 V3.xx compiler. If you wish to modify GO 
  168.     for a different compiler, good luck and don't-call-me-because-I-ain't-
  169.     never-going-to-call-you.
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.                                     3
  185.  
  186. 
  187.